home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / silence2.arc / SIL2.DOC < prev   
Text File  |  1985-09-16  |  14KB  |  395 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                     Silence
  19.  
  20.                                   Version 2.0
  21.                        Copywrite (c) 1985 by Carl Burtner
  22.  
  23.                      This Program Is In The Public Domain.
  24.               Users are encouraged to make as many copies as they
  25.               like and to distribute them to whomever they choose.
  26.  
  27.  
  28.                Under No Circumstances Is This Program To Be Sold.
  29.  
  30.  
  31.            If you have problems, questions, suggestions, or desire a
  32.                     copy of this programs assembler listing,
  33.                                please contact me.
  34.  
  35.                                   Carl Burtner
  36.                                 435 Brandon Road
  37.                             Rochester, N.Y.   14622
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.           Silence                                          Version 2.0
  72.  
  73.  
  74.           Silence is dedicated to keeping your PC quiet.  Most program
  75.           sounds will be eliminated entirely or reduced to a series of
  76.           clicks.  Some sound effects which use short duration tones
  77.           or turn the PC's interrupts off may not be silenced.
  78.  
  79.  
  80.                                  Compatibility
  81.  
  82.           Silence should be compatible with most programs and IBM-PC
  83.           compatible computers.  Silence 2.0 has some advanced options
  84.           which can enhance its ability to silence some previously
  85.           unsilenceable sounds.  These options may not be compatible
  86.           with all programs.  Incompatibility generally makes itself
  87.           evident by greatly slowing down the program.  When in doubt,
  88.           Silences default settings have never been observed to cause
  89.           problems.
  90.  
  91.  
  92.                                 Display Adapters
  93.  
  94.           To speed things up, Silence 2.0 uses direct writes to the
  95.           screen buffer for displaying the function access screen and
  96.           the copywrite notice.  To do this, Silence does its best to
  97.           determine the type of display adapter installed.  It is
  98.           possible that a non-standard adapter could fool Silence into
  99.           making a wrong assumption.  If this happens the display will
  100.           most likely remain blank.  To force Silence to ignore its
  101.           determination and use either the color or mono display
  102.           adapter enter the command "Sil2 c" for the color adapter or
  103.           "Sil2 m" for the mono adapter.
  104.  
  105.  
  106.                                   Installation
  107.  
  108.           Silence is a resident program.  Once installed, Silence
  109.           remains in the computers memory until it is turned off or
  110.           rebooted.  To install Silence just type the name of the
  111.           program (Sil2) and hit the return key.  Silence will
  112.           initialize and display a function access screen which allows
  113.           the setting of several options.  If you don't wish to change
  114.           any options either hit the escape key once or hit the return
  115.           key several times to tab to the end of the screen.  If you
  116.           wish you can install Silence without being presented with
  117.           the function access screen.  To do this enter "Sil2 d" (the
  118.           d stands for default) without the quotes.
  119.  
  120.           Silence's options may be changed at any time either by
  121.           entering one of the commands described below or by entering
  122.           Sil2 to use the function access screen.  However, because
  123.           Silence is a resident program it is possible that another
  124.           resident program installed after Silence may make it
  125.           impossible to change Silence's settings.  If this should
  126.           happen Silence will inform you.  To correct the problem try
  127.  
  128.  
  129.                                        -1-
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.           Silence                                          Version 2.0
  138.  
  139.  
  140.           rebooting and installing Silence after any other resident
  141.           program being used.
  142.  
  143.  
  144.                                     Commands
  145.  
  146.           Silence 2.0 supports the same commands as Silence 1.0.
  147.           These are:
  148.  
  149.  
  150.           Sil2 on      - Turns Silence on.  Program sounds will no
  151.                          longer be heard.  Error messages are returned
  152.                          if Silence has not been installed or if
  153.                          changing the setting is not possible.
  154.  
  155.  
  156.           Sil2 off     - Turns Silence off.  Program sounds will now be
  157.                          heard.  Error messages are returned if
  158.                          SILENCE has not been installed or if changing
  159.                          the setting is not possible.
  160.  
  161.           In addition, Silence 2.0 adds the following commands:
  162.  
  163.           Sil2 d       - Installs Silence without displaying the
  164.                          function access screen.
  165.  
  166.  
  167.           Sil2 c       - Installs Silence and/or displays the function
  168.                          access screen assuming that the color display
  169.                          adapter is installed
  170.  
  171.  
  172.           Sil2 m       - Installs Silence and/or displays the function
  173.                          access screen assuming that the monochrome
  174.                          display adapter is installed.
  175.  
  176.  
  177.           Only one command may be entered at a time.
  178.  
  179.  
  180.                               Theory of Operation
  181.  
  182.           System Clock
  183.  
  184.           The IBM PC has a system clock that "ticks" 18.2 times a
  185.           second.  Every time the clock ticks an interrupt is
  186.           generated.  The interrupt causes the computer to stop
  187.           whatever it is doing and execute a short program stored at a
  188.           previously defined location in memory.  The normal program
  189.           called at every clock tick updates the time of day and turns
  190.           off disk drive motors that have run too long.  After
  191.           completing its task, the interrupt routine returns the
  192.  
  193.  
  194.  
  195.                                        -2-
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.           Silence                                          Version 2.0
  204.  
  205.  
  206.           computer to doing exactly what it was doing before the
  207.           interrupt.
  208.  
  209.           Sound Generation
  210.  
  211.           Sound in the IBM PC is generated by a timer.  The timer is
  212.           loaded by a program with the desired frequency (pitch) and
  213.           begins to run.  The timers output tone goes to a gate
  214.           controlled by the computer.  The gate is connected to the
  215.           speaker and allows the tone supplied by the timer to be
  216.           turned on and off.
  217.  
  218.           Silence
  219.  
  220.           Silence operates by taking over the interrupt generated by
  221.           the system clock.  Every time the clock ticks, Silence is
  222.           called instead of the normal time of day routine.  Once
  223.           called, Silence turns off the gate to the speaker and sets
  224.           up the timer so that it produces a click instead of a tone.
  225.           After this, Silence passes control to the normal clock tick
  226.           routine so that the time of day and disk drives will operate
  227.           normally.  In this way, when a program produces a tone, the
  228.           tone will be turned off after 1/18.2 of a second and the
  229.           timer will only produce a click.  It is possible for a
  230.           program to set the computer to ignore the system clock tick.
  231.           When a program does this, Silence is temporarily disabled
  232.           and cannot turn off the sound.
  233.  
  234.           This summary has only covered Silence's basic operation.
  235.           Silence's advanced options such as Burst Delay and
  236.           Acceleration alter certain aspects of the way Silence works
  237.           to provide the user with greater silencing power.  These
  238.           options are described more fully below.
  239.  
  240.  
  241.                                     Options
  242.  
  243.           There are several options that may only be changed by using
  244.           the function access screen.  To display these options enter
  245.           Sil2 (or "Sil2 c" or "Sil2 m" if your adapter is
  246.           non-standard).  The function access screen will be displayed
  247.           along with the current settings of the options.  To change
  248.           the settings use the return key to tab to the desired
  249.           option, select a setting from the menu, and hit the return
  250.           key.  If you make a mistake, the backspace key can be used
  251.           to correct it.  To exit from the function access screen
  252.           either hit the return key to tab to the end of the screen or
  253.           hit the escape key to exit immediately.  If you select a
  254.           setting from the menu and hit the escape key instead of the
  255.           return key your selection will be ignored, the function
  256.           access screen will be exited, and the setting of the option
  257.           will not be changed.
  258.  
  259.  
  260.  
  261.                                        -3-
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.           Silence                                          Version 2.0
  270.  
  271.  
  272.           The available options are as follows:
  273.  
  274.           Silence         1. On        2. Off
  275.  
  276.           Timer Mode      1. Program Controlled     2. Beep    3. Click
  277.  
  278.           Speaker Enable  1. Program Controlled     2. Silence Controlled
  279.  
  280.           Burst Delay     1. Off       2. 1  Sec.   3. 2  Sec.
  281.                           4. 5 Sec.    5. 10 Sec.   6. 15 Sec.
  282.  
  283.           Acceleration    1. 1X (off)  2. 5X        3. 10X
  284.                           4. 50X       5. 100X      6. 255X
  285.  
  286.           Blink           1. On        2. Off
  287.  
  288.  
  289.           Silence
  290.  
  291.           Silence On and Off perform as described in the command
  292.           section.
  293.  
  294.           Timer Mode
  295.  
  296.           Timer Mode controls the mode Silence uses at every clock
  297.           tick to reset the timer that produces the tones.  The
  298.           default is to reset the timer to produce clicks.  If you
  299.           change the setting to Beeps with the Speaker Enable under
  300.           control of Silence, short beeps will be produced instead of
  301.           clicks.  If you set the Timer Mode for Program Control,
  302.           Silence will not alter the mode of the timer.
  303.  
  304.           Speaker Enable
  305.  
  306.           Speaker Enable allows the speaker to be under control of
  307.           Silence or the users program.  Under Silence's control the
  308.           speaker will be turned off at every system clock tick.  If
  309.           option 1 is selected Silence will leave the speaker alone.
  310.  
  311.           Setting the Timer Mode and Speaker Enable to Program
  312.           Controlled with the Burst Delay, Acceleration, and Blink off
  313.           is the same as turning Silence Off.
  314.  
  315.           Burst Delay
  316.  
  317.           Burst Delay is an advanced option that is useful in certain
  318.           situations.  Not all programs work normally with the Burst
  319.           Delay option activated.  Burst Delay waits the selected
  320.           amount of time before passing along any system clock ticks
  321.           to other interrupts.  When the Burst Delay period expires
  322.           the clock ticks which occurred during the delay are passed
  323.           along all at once.  If a game program is using the system
  324.           clock to generate continuous melodies the Burst Delay option
  325.  
  326.  
  327.                                        -4-
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.           Silence                                          Version 2.0
  336.  
  337.  
  338.           will cause the program to emit a long pause followed by an
  339.           unrecognizably short burst of sound consisting of all the
  340.           tones that would normally have occurred during the pause.
  341.  
  342.           Acceleration
  343.  
  344.           Acceleration controls the speed of the system clock.
  345.           Normally, the system clock produces about 18.2 clock ticks
  346.           every second.  The Acceleration option allows you to change
  347.           the number of clock ticks produced per second from 18.2 to
  348.           over 4,000.  Because Silence turns off the speaker at every
  349.           clock, there are instances where turning the speaker off up
  350.           to 4,000 times a second can be much more effective than
  351.           turning it off 18.2 times a second.  Acceleration is not
  352.           compatible or effective with all programs.  If a program
  353.           takes over the system clock (most do not), the accelerated
  354.           clock may cause erratic behavior or lock up.  If a program
  355.           turns off the interrupts while producing sound, Acceleration
  356.           will have no effect.  It is recommended that Acceleration
  357.           only be used when necessary.  Do not routinely set
  358.           Acceleration to 255X every time Silence is initialized.  
  359.           Use Acceleration only with those programs with which
  360.           it is needed, effective and compatible.
  361.  
  362.           Using Burst Delay and Acceleration
  363.  
  364.           The Burst Delay and Acceleration options are not designed to
  365.           be used with all programs or at all times.  These options
  366.           are provided to give you, the user, more powerful tools for
  367.           silencing toublesome programs.  The best course to follow is
  368.           to experiment to find the most effective and compatible
  369.           settings for each program.  Don't be surprised if some
  370.           programs behave erratically or even lock up with some Burst
  371.           Delay and Acceleration combinations.  On the other hand,
  372.           these options can be great fun (especially with on screen
  373.           clocks), so don't be afraid to experiment.  If you have any
  374.           questions or serious problems, please contact me.
  375.  
  376.           Blink
  377.  
  378.           Blink, when activated, puts a small square in the upper left
  379.           corner of the screen and turns it on and off once a second.
  380.           Blink is a continuous visual reminder of the status of
  381.           Silence.  If Silence is turned off, or if a program takes
  382.           over Silence's interrupt, the box will no longer blink.  In
  383.           graphics modes Blink's box will appear as a short flashing
  384.           line.  If you have a color monitor and adapter, Blink causes
  385.           a very small amount of "hash" to appear on the screen.  If
  386.           you find this to be extremely offensive, let me know.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                        -5- 
  394. 
  395.